home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / delta.z / delta
Encoding:
Text File  |  2002-10-03  |  8.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4. DDDDEEEELLLLTTTTAAAA((((1111))))                                                              DDDDEEEELLLLTTTTAAAA((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      delta - make a delta (change) to an SCCS file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ddddeeeellllttttaaaa [----rrrr SID] [----ssss] [----nnnn] [----gggg list] [----mmmm mmmmrrrrlllliiiisssstttt]]]] [[[[----yyyy[comment]] [----pppp] files
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _d_e_l_t_a is used to permanently introduce into the named SCCS file changes
  16.      that were made to the file retrieved by _g_e_t(1) (called the _g-_f_i_l_e, or
  17.      generated file).
  18.  
  19.      _d_e_l_t_a makes a delta to each named SCCS file.  If a directory is named,
  20.      _d_e_l_t_a behaves as though each file in the directory were specified as a
  21.      named file, except that non-SCCS files (last component of the path name
  22.      does not begin with ssss....)  and unreadable files are silently ignored.  If a
  23.      name of ---- is given, the standard input is read (see _W_A_R_N_I_N_G_S); each line
  24.      of the standard input is taken to be the name of an SCCS file to be
  25.      processed.
  26.  
  27.      _d_e_l_t_a may issue prompts on the standard output depending upon certain
  28.      keyletters specified and flags [see _a_d_m_i_n(1)] that may be present in the
  29.      SCCS file (see ----mmmm and ----yyyy keyletters below).
  30.  
  31.      Keyletter arguments apply independently to each named file.
  32.  
  33.           ----rrrr_S_I_D          Uniquely identifies which delta is to be made to the
  34.                          SCCS file.  The use of this keyletter is necessary
  35.                          only if two or more outstanding _g_e_ts for editing (ggggeeeetttt
  36.                          ----eeee) on the same SCCS file were done by the same
  37.                          person (login name).  The SID value specified with
  38.                          the ----rrrr keyletter can be either the SID specified on
  39.                          the _g_e_t command line or the SID to be made as
  40.                          reported by the _g_e_t command [see _g_e_t(1)].  A
  41.                          diagnostic results if the specified SID is ambiguous,
  42.                          or, if necessary and omitted on the command line.
  43.  
  44.           ----ssss             Suppresses the issue, on the standard output, of the
  45.                          created delta's SID, as well as the number of lines
  46.                          inserted, deleted and unchanged in the SCCS file.
  47.  
  48.           ----nnnn             Specifies retention of the edited _g-_f_i_l_e (normally
  49.                          removed at completion of delta processing).
  50.  
  51.           ----gggg_l_i_s_t         a _l_i_s_t (see _g_e_t(1) for the definition of _l_i_s_t) of
  52.                          deltas which are to be _i_g_n_o_r_e_d when the file is
  53.                          accessed at the change level (SID) created by this
  54.                          delta.
  55.  
  56.           ----mmmm[_m_r_l_i_s_t]     If the SCCS file has the vvvv flag set [see _a_d_m_i_n(1)]
  57.                          then a Modification Request (MMMMRRRR) number _m_u_s_t be
  58.                          supplied as the reason for creating the new delta.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DDDDEEEELLLLTTTTAAAA((((1111))))                                                              DDDDEEEELLLLTTTTAAAA((((1111))))
  71.  
  72.  
  73.  
  74.                          If ----mmmm is not used and the standard input is a
  75.                          terminal, the prompt MMMMRRRRssss???? is issued on the standard
  76.                          output before the standard input is read; if the
  77.                          standard input is not a terminal, no prompt is
  78.                          issued.  The MMMMRRRRssss???? prompt always precedes the
  79.                          ccccoooommmmmmmmeeeennnnttttssss???? prompt (see ----yyyy keyletter).
  80.  
  81.                          MMMMRRRRs in a list are separated by blanks and/or tab
  82.                          characters.  An unescaped new-line character
  83.                          terminates the MMMMRRRR list.
  84.  
  85.                          Note that if the vvvv flag has a value [see _a_d_m_i_n(1)],
  86.                          it is taken to be the name of a program (or shell
  87.                          procedure) which will validate the correctness of the
  88.                          MMMMRRRR numbers.  If a non-zero exit status is returned
  89.                          from the MMMMRRRR number validation program, _d_e_l_t_a
  90.                          terminates.  (It is assumed that the MMMMRRRR numbers were
  91.                          not all valid.)
  92.  
  93.           ----yyyy[_c_o_m_m_e_n_t]    Arbitrary text used to describe the reason for making
  94.                          the delta.  A null string is considered a valid
  95.                          _c_o_m_m_e_n_t.
  96.  
  97.                          If ----yyyy is not specified and the standard input is a
  98.                          terminal, the prompt ccccoooommmmmmmmeeeennnnttttssss???? is issued on the
  99.                          standard output before the standard input is read; if
  100.                          the standard input is not a terminal, no prompt is
  101.                          issued.  An unescaped new-line character terminates
  102.                          the comment text.
  103.  
  104.           ----pppp             Causes _d_e_l_t_a to print (on the standard output) the
  105.                          SCCS file differences before and after the delta is
  106.                          applied in a _d_i_f_f(1) format.
  107.  
  108. FFFFIIIILLLLEEEESSSS
  109.      g-file           Existed before the execution of _d_e_l_t_a; removed after
  110.                       completion of _d_e_l_t_a.
  111.      p-file           Existed before the execution of _d_e_l_t_a; may exist after
  112.                       completion of _d_e_l_t_a.
  113.      q-file           Created during the execution of _d_e_l_t_a; removed after
  114.                       completion of _d_e_l_t_a.
  115.      x-file           Created during the execution of _d_e_l_t_a; renamed to SCCS
  116.                       file after completion of _d_e_l_t_a.
  117.      z-file           Created during the execution of _d_e_l_t_a; removed during
  118.                       the execution of _d_e_l_t_a.
  119.      d-file           Created during the execution of _d_e_l_t_a; removed after
  120.                       completion of _d_e_l_t_a.
  121.      /usr/bin/bdiff   Program to compute differences between the ``gotten''
  122.                       file and the _g-_f_i_l_e.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. DDDDEEEELLLLTTTTAAAA((((1111))))                                                              DDDDEEEELLLLTTTTAAAA((((1111))))
  137.  
  138.  
  139.  
  140. WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  141.      Lines beginning with an SSSSOOOOHHHH ASCII character (binary 001) cannot be placed
  142.      in the SCCS file unless the SSSSOOOOHHHH is escaped.  This character has special
  143.      meaning to SCCS [see _s_c_c_s_f_i_l_e(4) (5)] and will cause an error.
  144.  
  145.      A _g_e_t of many SCCS files, followed by a _d_e_l_t_a of those files, should be
  146.      avoided when the _g_e_t generates a large amount of data.  Instead, multiple
  147.      _g_e_t/_d_e_l_t_a sequences should be used.
  148.  
  149.      If the standard input (----) is specified on the _d_e_l_t_a command line, the ----mmmm
  150.      (if necessary) and ----yyyy keyletters _m_u_s_t also be present.  Omission of these
  151.      keyletters causes an error to occur.
  152.  
  153.      Comments are limited to text strings of at most 512 characters.
  154.  
  155. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  156.      admin(1), bdiff(1), cdc(1), get(1), help(1), prs(1), rmdel(1),
  157.      sccsfile(4)
  158.  
  159. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  160.      Use _h_e_l_p(1) for explanations.
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.